docs: Mention focus adjustments in the migration guide

diff --git a/docs/reference/gtk/migrating-3to4.xml b/docs/reference/gtk/migrating-3to4.xml
index a7867f2e17ef0f8dc05264711def98ff42416880..f1f8455b1977f485c42f5b00feb60baf61907258 100644 (file)
--- a/docs/reference/gtk/migrating-3to4.xml
+++ b/docs/reference/gtk/migrating-3to4.xml
@@ -494,6 +494,12 @@
         The recommended way to influence focus behavior of custom widgets
         in GTK 4 is to override the focus() and grab_focus() vfuncs.
       </para>
+      <para>
+        The feature to automatically keep the focus widget scrolled into view
+        with gtk_container_set_focus_vadjustment() has been removed from
+        GtkContainer, and is provided by scrollables instead. In the common case
+        that the scrollable is a #GtkViewport, use #GtkViewport:scroll-to-focus.
+      </para>
     </section>
 
     <section>